快速开始
python
搭建示例应用模板，包含定时触发，VS Code，文本显示（前面板组件）三个节点，模板运行时，每5秒触发一次VS Code节点代码执行，并通过文本显示组件显示执行结果，执行结果为 “Hello 算盘！<执行时间戳>” 的动态字符串。观看视频教程关注VS Code组件的编辑，调试，重启基本功能使用。
1. 选中VS Code节点，选择开发语言**“python”**，点击**“编辑”**
- 新建 cmd 终端，运行venv_config.bat，配置python虚拟环境，并安装算盘python sdk依赖
执行完毕后，关闭VS Code
选择启动运行程序“是”，点击顶部运行按钮
- 启动完成，打开前面板
页面显示 Hello 算盘！<时间戳>，每一秒更新一次
项目运行期间可以动态修改和调试节点代码，点击 “调试”
- 选择当前虚拟环境的解释器 .\Scripts\python.exe，如果列表里看不到，请刷新列表，VS Code会动态发现当前虚拟环境，选中后，点击菜单 运行-> 启动调试
- 添加断点，调试相关逻辑
- 调试完成后，关闭调试器和VS Code，重启节点，修改生效
Java
- 使用vscode（java）组件时，vscode需安装Java语言工具包-Java Extension Pack，该工具包自带6个插件（如已安装可跳过，用户也可按照自身需要分别安装下列插件）：
- Language Support for Java(TM) by Red Hat： 必选，编辑器、代码导航、断点、编译、反射等支持（本地需已安装JDK，可运行java -version命令查看本地Java版本）
- Debugger for Java： 必选，调试java代码
- Java Test Runner：可选，JUnit/TestNG测试发现
- Maven for Java：必选，管理maven项目（本地需已安装Maven，可运行mvn -version命令查看本地maven版本）
- Project Manager for Java：可选，提供java项目的发现、目录管理、Libraries管理、资源管理、包/类/类成员等管理支持
- Visual Studio IntelliCode：可选，增强软件开发
安装插件：
安装完成后，可点击“已安装”查看安装的插件：
- 拖入vscode组件，选择开发语言“java”，点击“编辑”按钮，打开VS Code，编辑代码
- 编辑完成后关闭VS Code软件，在算盘点击“运行”或“调试”按钮运行或调试代码
- 若需运行用户自己的java项目，在“工作路径”填写java项目路径（绝对路径）
- 点击“编辑”按钮，打开VS Code软件，修改pom.xml文件中
<build>的<finalName>标签指定生成的jar名称（不需要编译、打包可跳过此步）
- 关闭VS Code软件，在“启动文件”填写jar包路径“./target/XXX.jar”（路径可以是“工作路径”下的相对路径，也可以是绝对路径，不填将会运行默认路径下的jar文件./target/sp-java-demo.jar）
- 点击“运行”按钮后，vscode节点会自动编译打包Java项目，在项目target目录下生成XXX.jar文件，并运行该文件
常见问题
编辑打开 vscode 为什么不能调试
未部署应用前：可点击 VS Code 组件节点右上角编辑按钮打开 vscode。此时仅仅是打开 vscode IDE，可以查看、编辑代码等，如果运行或调试程序可能会失败，因为程序依赖的算盘 SDK 会用到应用运行时动态产生的环境变量和各种参数等信息。详见下方运行机制说明。如果想调试程序，请先部署应用后通过调试按钮打开 vscode。
调试打开 vscode 为什么没有停止程序
部署应用后：可点击 VS Code 组件节点右上角调试按钮打开 vscode。因为应用已经运行，此时可以通过 vscode IDE 进行调试程序了。调试程序只会停止之前通过 VS Code 组件启动的程序（包括1：是否启动程序配置为是；2：右上角点击重启），而不会停止经过其他方式（比如 vscode IDE 下方的控制终端或系统控制终端）启动的程序。详见下方调试、重启说明。
运行机制
概述
算盘环境提供了 VS Code 组件，方便用户编写、调试自己的组件程序。本质上组件程序就是接收上一个组件节点的输出数据作为输入，然后自定义处理逻辑将输出数据作为下一个组件节点的输入。一个组件的功能逻辑如下图所示：
为了方便用户开发自己的组件程序，官方提供了 Python、Node、Java 等编程语言的算盘 SDK，用户无需关心如何接收输入数据、如何将输出数据发送到下一个节点等细节，只需要定义自己的处理逻辑即可。但是算盘 SDK 依托于组件节点运行时传入的算盘参数（argvs）和环境变量（env），这些算盘参数（argvs）和环境变量（env）是应用部署时算盘环境动态生成并传给组件节点的。
因此为了用户方便地编写、测试自己的组件程序，我们做了一个壳组件，即 VS Code 组件（以下简称VS Code），它的主要功能就是接收动态生成的算盘参数和环境变量，然后转发给用户自定义的组件程序，并且可以打开本地安装好的 vscode IDE（以下简称 vscode），方便用户直接编写代码或调试代码。VS Code 组件逻辑示意图：
这样，用户就可以在自己的本地环境上开发、调试自己的组件程序了。
【注意】点击 VS Code 组件的右面板上角的操作按钮，比如编辑（应用未运行状态下）、调试（应用运行状态下）等，会自动打开本地环境的 vscode，然后等待你编辑代码或调试代码，所以需要在本地环境上提前安装好 vscode。假如已经安装好 vscode，但是通过算盘打不开，请重启算盘或电脑，以保证算盘启动前能够正确识别 vscode 的安装环境。
安装好 vscode 后，下面详细介绍下 VS Code 组件的使用流程及方法。
新建节点
使用 VS Code 组件新建节点，如下所示：
新建节点后，会将官方自带示例程序解压到了算盘安装根目录（例如我们将算盘安装到了E:\suanpan-desktop）下对应的子目录。
删除、恢复节点
在节点右键点击删除操作，即可删除节点（节点删除中间状态，并未清理相关数据）。
如果想恢复节点，请在删除节点后，立即在面板空白处点击右键撤销操作（或快捷键Ctrl+z），即可恢复该节点。否则，当进行了其它的操作后，该节点以及相关目录下的数据都会被真正地删除。即：如果删除节点后，又进行了其它操作，不可再恢复该节点。
【注意】如果你的组件代码是保存在节点提供的临时目录（算盘安装根目录/data/minio/...）下，那么请注意备份好，如果节点真正被删除，那么节点相关目录下的数据（包括你的代码）都会被清理。如果你的代码是保存在其他目录下的，节点删除时并不会清理相关数据。详情见下面的工作路径设置。
工作路径
工作路径就是用户自定义组件程序运行时的工作路径（working directory）。默认是节点的临时运行目录（因为默认的代码示例也是在该目录下），用户可指定为其他路径，一般设置为你的程序所在的根目录。
【注意】当设置成其他路径时，其中的数据是保留的，因为真正删除节点时，只会清理节点临时运行目录下的数据。如果当节点删除时，你不需要保留其中修改的代码，直接使用默认的配置即可，否则，最好设置成其他的路径。该参数只能设置成绝对路径，否则按照默认的工作路径处理。
启动文件
启动文件即程序的入口文件。以 Node 语言为例，默认的启动文件为index.js。当启动用户的组件程序时，会在上述配置的工作路径下执行node index.js。如果需要，用户可配置成其他的js文件。
是否启动程序
当运行应用时，会启动 VS Code 节点。此时，VS Code 会根据该是否启动程序配置，选择是否启动用户的组件程序，即是否运行node index.js。
【注意】如果选择是，请提前确保你的组件程序能正常运行（比如，安装好程序依赖npm install或pip install -r requirements.txt）。如果组件程序有问题，启动失败，那么会造成 VS Code 节点也会运行失败并退出。因此，如果处于组件开发阶段，那么建议选择默认的否即可，因为 VS Code 节点并不会启动程序，因而也不会有问题进而退出。
操作说明
编辑
在未部署应用时，可点击 VS Code 节点右面板上方的编辑按钮，打开本地环境的 vscode，此时可进行代码的查看或编辑，但是不能调试，因为应用还未部署。
调试、重启
当部署应用后，可点击右上方的调试、重启按钮。它们分别做以下的操作：
- 点击调试按钮时：首先，停止用户的组件程序（如果已经启动的情况下）；然后，将算盘运行时参数和环境变量写入到工作路径下的
.vscode/launch.json（vscode 的调试配置文件）中；最后，打开本地的 vscode。用户即可进行代码编辑或调试。当用户关闭 vscode 后，算盘并不会自动启动用户的组件程序，此行为由用户决定，见下方重启按钮的功能。 - 点击重启按钮时：先停止用户的组件程序（如果已经启动的情况下），然后再启动用户的组件程序。通常配合调试场景使用，当调试（修改）代码确定程序没有问题后，可关闭调试，点击重启按钮，即可再次启动新的组件程序。
【注意】上述“停止用户的组件程序”指的是：经过 VS Code 组件启动或重启的组件程序。VS Code 组件会记录启动程序的进程信息，因此知道如何停止用户的程序。如果用户经过其他方式自己启动的组件程序（比如通过 vscode 的控制终端启动程序等），那么 VS Code 组件并不知道相关进程信息，即：它认为用户的组件程序并没有运行。
使用示例
以下我们以 Node 语言为例。
单节点示例
拖动 VS Code 组件到面板后，点击上方运行按钮，此时 VS Code 组件节点已经运行了。
我们可点击右上方调试按钮，打开 vscode，查看下官方自带示例。如下图所示：
此时，VS Code 组件节点已经将算盘运行时相关参数（argvs）和环境变量（env）传入到了 vscode 中的调试配置文件（.vscode/launch.json）中。用户可点击 vscode 上方菜单栏运行中的启动调试功能（或者直接按快捷键F5）即可调试该示例程序。如下图所示，已经正常运行。
点击算盘下方的面板，即可看到该节点的实时输出日志。
示例程序很简单，多处已经加了注释，不再赘述。更多 SDK 使用文档，请参考下方附录部分。
【注意】示例程序开头出会自动安装算盘 SDK 等依赖，第一次运行时较为慢些，请耐心等待。
多节点示例
我们拖动三个VS Code 组件节点到面板，均设置开发语言为 nodejs，是否启动程序选择是。因为官方示例程序均可正常运行，为了方便，我们选择应用运行时直接启动程序。第一次运行稍慢，会安装算盘 SDK 依赖，等节点全部正常运行时，可从下方面板看到每个节点的实时输出日志，也可看到数据在节点中的流动。
调试技巧
VS Code 组件能够为用户开发、调试组件程序带来很大的方便，但是用户组件程序的组织、运行方式等并不是统一的。比如，有的组件程序中用到了一些第三方框架、或者启动方式为通过第三方命令间接启动（如npm run xxx）等。此时，vscode 的调试配置文件需要根据用户的实际情况调整些配置参数。因为 VS Code 组件并不能考虑到所有的可能的程序组织、运行方式，所以，VS Code 组件节点在生成 vscode 的调试配置文件（.vscode/launch.json）时，并不会全部覆盖重写，而是在文件有效（文件无效会全部重写）的前提下，仅重写官方指定的固定名字的配置项。
因此，当 VS Code 组件节点生成的默认的配置项并不能完全符合用户目前程序调试的要求时，用户可将生成的算盘运行时参数（argvs）和环境变量（env）拷贝复制到自定义的配置项中，即可调试用户的组件程序。
VS Code 组件保持简单使用的同时，也尽可能满足了不同用户的不同环境配置，提供了很大的灵活性。
注意问题
请仔细阅读使用文档，尤其是每个小节部分的注意事项内容。VS Code 组件功能也会不断地更新，提高用户的使用体验。您可持续关注雪浪云官方网站或者相关活动，及时体验最新版本算盘带来的新功能。
如果遇到什么问题，或者好的想法，请通过官方渠道及时提供您宝贵的意见。
附录
组件制作
SDK 文档
- Python
- Node
- Java